home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-pusateri-igmp-mib-00.txt < prev    next >
Text File  |  1993-07-08  |  17KB  |  658 lines
  1.  
  2.  
  3.  
  4.                                                              T. Pusateri
  5. INTERNET DRAFT                                                Consultant
  6. Expiration date: September 1993                                June 1993
  7.  
  8.  
  9.        Managed Objects for the Internet Group Management Protocol
  10.  
  11.  
  12.  
  13. 1.  Abstract
  14.  
  15.  
  16.  
  17. This memo defines a portion of the Management Information Base (MIB) for
  18. use with network management protocols in TCP/IP based internets.  In
  19. particular it defines objects for managing the Internet Group Management
  20. Protocol (IGMP) defined in RFC 1112 [1].
  21.  
  22.  
  23. 2.  Status of this Memo
  24.  
  25.  
  26.  
  27. This document will be submitted to the RFC editor as an extension to the
  28. SNMP MIB.  Distribution of this memo is unlimited.  Please send comments
  29. to the authors.
  30.  
  31. This document is an Internet Draft.  Internet Drafts are working
  32. documents of the Internet Engineering Task Force (IETF), its Areas, and
  33. its Working Groups. Note that other groups may also distribute working
  34. documents as Internet Drafts.
  35.  
  36. Internet Drafts are draft documents valid for a maximum of six months.
  37. Internet Drafts may be updated, replaced, or obsoleted by other
  38. documents at any time.  It is not appropriate to use Internet Drafts as
  39. reference material or to cite them other than as a "working draft" or
  40. "work in progress."
  41.  
  42. Please check the I-D abstract listing contained in each Internet Draft
  43. directory to learn the current status of this or any other Internet
  44. Draft.
  45.  
  46.  
  47. 3.  The Network Management Framework
  48.  
  49.  
  50.  
  51. The Internet-standard Network Management Framework consists of three
  52.  
  53.  
  54.  
  55. Pusateri                                                        [Page 1]
  56.  
  57.  
  58.  
  59.  
  60.  
  61. INTERNET DRAFT                                             February 1993
  62.  
  63.  
  64. components.  They are:
  65.  
  66. RFC 1155 [2]
  67.      which defines the SMI, the mechanisms used for describing and
  68.      naming objects for the purpose of management.  RFC 1212 [3] defines
  69.      a more concise description mechanism, which is wholly consistent
  70.      with the SMI.
  71.  
  72.  
  73. RFC 1156 [4]
  74.      which defines MIB-I, the core set of managed objects for the
  75.      Internet suite of protocols.  RFC 1213 [5], defines MIB-II, an
  76.      evolution of MIB-I based on implementation experience and new
  77.      operational requirements.
  78.  
  79.  
  80. RFC 1157 [6]
  81.      which defines the SNMP, the protocol used for network access to
  82.      managed objects.
  83.  
  84.      The Framework permits new objects to be defined for the purpose of
  85.      experimentation and evaluation.
  86.  
  87.  
  88. 4.  Objects
  89.  
  90.  
  91.  
  92. Managed objects are accessed via a virtual information store, termed the
  93. Management Information Base or MIB.  Objects in the MIB are defined
  94. using the subset of Abstract Syntax Notation One (ASN.1) [7] defined in
  95. the SMI.  In particular, each object has a name, a syntax, and an
  96. encoding.  The name is an object identifier, an administratively
  97. assigned name, which specifies an object type.  The object type together
  98. with an object instance serves to uniquely identify a specific
  99. instantiation of the object.  For human convenience, we often use a
  100. textual string, termed the OBJECT DESCRIPTOR, to also refer to the
  101. object type.
  102.  
  103. The syntax of an object type defines the abstract data structure
  104. corresponding to that object type.  The ASN.1 language is used for this
  105. purpose.  However, the SMI purposely restricts the ASN.1 constructs
  106. which may be used.  These restrictions are explicitly made for
  107. simplicity.
  108.  
  109. The encoding of an object type is simply how that object type is
  110. represented using the object type's syntax.  Implicitly tied to the
  111. notion of an object type's syntax and encoding is how the object type is
  112.  
  113.  
  114.  
  115. Pusateri                                                        [Page 2]
  116.  
  117.  
  118.  
  119.  
  120.  
  121. INTERNET DRAFT                                             February 1993
  122.  
  123.  
  124. represented when being transmitted on the network.
  125.  
  126. The SMI specifies the use of the basic encoding rules of ASN.1 [8],
  127. subject to the additional requirements imposed by the SNMP.
  128.  
  129. Format of Definitions
  130.  
  131.  
  132. Section 6 contains the specification of all object types contained in
  133. this MIB module.  The object types are defined using the conventions
  134. defined in the SMI, as amended by the extensions specified in RFC1212.
  135.  
  136.  
  137. 5.  Overview
  138.  
  139.  
  140.  
  141. This MIB provides a general mechanism to determine the group membership
  142. information on a per interface basis. It was designed to be used for
  143. both end systems and multicast routers.
  144.  
  145. For each interface on the box, there is a table indexed by IfIndex.  It
  146. denotes the status of IGMP on the interface. Various Host Membership
  147. Query statistics are maintained. A group membership table is kept in
  148. addition indexed by the interface and group address.  In this table,
  149. Host Membership Report information as well as group statistics are kept.
  150.  
  151. It is the intention of this document to specify MIB definitions for only
  152. the part of IGMP that is protocol independent.  This excludes any IGMP
  153. message types currently in use for Distance Vector Multicast Routing
  154. Protocol (DVMRP). There is a companion document that will specify a
  155. Management Information Base for entries in the IP Multicast forwarding
  156. cache. Each cache entry can provide a protocol specific object
  157. identifier containing protocol dependent information about the protocol
  158. that installed the cache entry.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175. Pusateri                                                        [Page 3]
  176.  
  177.  
  178.  
  179.  
  180.  
  181. INTERNET DRAFT                                             February 1993
  182.  
  183.  
  184. 6. Definitions
  185.  
  186.  
  187.  
  188. IGMP-MIB DEFINITIONS ::= BEGIN
  189.  
  190. IMPORTS
  191.         Counter, IpAddress, TimeTicks, experimental
  192.                 FROM RFC1155-SMI
  193.         OBJECT-TYPE
  194.                 FROM RFC-1212;
  195.  
  196. -- This MIB module defines an information base for the Internet
  197. -- Group Management Protocol (IGMP). It is based on the specification
  198. -- found in RFC 1112.
  199.  
  200. -- Please send any comments to Tom Pusateri (pusateri@cs.duke.edu).
  201.  
  202. -- Thanks to Greg Minshall and Jeff Honig for their review and comments.
  203. -- $Id: igmp.mib,v 1.7 1993/06/22 20:23:46 pusateri Exp $
  204.  
  205. igmp OBJECT IDENTIFIER ::= { experimental xxx }
  206.  
  207. igmpVersionNumber OBJECT-TYPE
  208.         SYNTAX  INTEGER
  209.         ACCESS  read-only
  210.         STATUS  mandatory
  211.         DESCRIPTION
  212.                 "The current version of IGMP."
  213.         ::= { igmp 1 }
  214.  
  215. igmpInterfaceTable OBJECT-TYPE
  216.         SYNTAX  SEQUENCE OF IgmpInterfaceEntry
  217.         ACCESS  not-accessible
  218.         STATUS  mandatory
  219.         DESCRIPTION
  220.                 "Information about the group membership on each
  221.                 interface."
  222.         ::= { igmp 2 }
  223.  
  224. igmpInterfaceEntry OBJECT-TYPE
  225.         SYNTAX  IgmpInterfaceEntry
  226.         ACCESS  not-accessible
  227.         STATUS  mandatory
  228.         DESCRIPTION
  229.                 "An interface that supports IGMP."
  230.         INDEX { igmpIfIndex }
  231.         ::= { igmpInterfaceTable 1 }
  232.  
  233.  
  234.  
  235. Pusateri                                                        [Page 4]
  236.  
  237.  
  238.  
  239.  
  240.  
  241. INTERNET DRAFT                                             February 1993
  242.  
  243.  
  244. IgmpInterfaceEntry ::=
  245.     SEQUENCE {
  246.         igmpIfIndex
  247.             INTEGER,
  248.         igmpIfStatus
  249.             INTEGER,
  250.         igmpDiscards
  251.             Counter,
  252.         igmpOutQueries
  253.             Counter,
  254.         igmpInQueries
  255.             Counter,
  256.         igmpQueryInterval
  257.             INTEGER,
  258.         igmpUnregisteredPkts
  259.             Counter
  260.     }
  261.  
  262. igmpIfIndex OBJECT-TYPE
  263.         SYNTAX  INTEGER
  264.         ACCESS  read-only
  265.         STATUS  mandatory
  266.         DESCRIPTION
  267.                 "This value is a unique integer for each interface
  268.                 as identified by the same value of IfIndex."
  269.         ::= { igmpInterfaceEntry 1 }
  270.  
  271. igmpIfStatus OBJECT-TYPE
  272.         SYNTAX  INTEGER { enabled(1), disabled(2) }
  273.         ACCESS  read-write
  274.         STATUS  mandatory
  275.         DESCRIPTION
  276.                 "The status of IGMP with respect to this interface.
  277.                 A value of 1 is enabled, while a value of 2 is disabled."
  278.         ::= { igmpInterfaceEntry 2 }
  279.  
  280. igmpDiscards OBJECT-TYPE
  281.         SYNTAX  Counter
  282.         ACCESS  read-only
  283.         STATUS  mandatory
  284.         DESCRIPTION
  285.                 "The number of IGMP messages received on
  286.                 this interface that were discarded
  287.                 due to bad checksums, illegal message types, bad
  288.                 values in fields, etc."
  289.         ::= { igmpInterfaceEntry 3 }
  290.  
  291. igmpOutQueries OBJECT-TYPE
  292.  
  293.  
  294.  
  295. Pusateri                                                        [Page 5]
  296.  
  297.  
  298.  
  299.  
  300.  
  301. INTERNET DRAFT                                             February 1993
  302.  
  303.  
  304.         SYNTAX  Counter
  305.         ACCESS  read-only
  306.         STATUS  mandatory
  307.         DESCRIPTION
  308.                 "The number of Host Membership Query messages sent
  309.                 out of this interface."
  310.         ::= { igmpInterfaceEntry 4 }
  311.  
  312. igmpInQueries OBJECT-TYPE
  313.         SYNTAX  Counter
  314.         ACCESS  read-only
  315.         STATUS  mandatory
  316.         DESCRIPTION
  317.                 "The number of Host Membership Query messages that
  318.                 have been received on this interface."
  319.         ::= { igmpInterfaceEntry 5 }
  320.  
  321. igmpQueryInterval OBJECT-TYPE
  322.         SYNTAX  INTEGER (0..'7FFFFFFF'h)
  323.         ACCESS  read-write
  324.         STATUS  mandatory
  325.         DESCRIPTION
  326.                 "The interval in seconds in which Host Membership
  327.                 Queries should be sent out on this interface. This
  328.                 value is only valid when igmpIfStatus is set to
  329.                 enabled(1) and ipMulticastForwarding is set to
  330.                 forwarding(1)."
  331.         ::= { igmpInterfaceEntry 6 }
  332.  
  333. igmpUnregisteredPkts OBJECT-TYPE
  334.         SYNTAX  Counter
  335.         ACCESS  read-only
  336.         STATUS  mandatory
  337.         DESCRIPTION
  338.                 "The number of multicast datagrams received on the
  339.                 interface for groups that are not registered with
  340.                 that interface. Useful for checking hardware address
  341.                 filters. May also occur due to only filtering 23 bits
  342.                 or when all hardware multicast frames are received."
  343.         ::= { igmpInterfaceEntry 7 }
  344.  
  345. igmpGroupTable OBJECT-TYPE
  346.         SYNTAX  SEQUENCE OF IgmpGroupEntry
  347.         ACCESS  not-accessible
  348.         STATUS  mandatory
  349.         DESCRIPTION
  350.                 "Statistics on a per interface basis for each
  351.                 IP multicast group registered."
  352.  
  353.  
  354.  
  355. Pusateri                                                        [Page 6]
  356.  
  357.  
  358.  
  359.  
  360.  
  361. INTERNET DRAFT                                             February 1993
  362.  
  363.  
  364.         ::= { igmp 3 }
  365.  
  366. igmpGroupEntry OBJECT-TYPE
  367.         SYNTAX  IgmpGroupEntry
  368.         ACCESS  not-accessible
  369.         STATUS  mandatory
  370.         DESCRIPTION
  371.                 "The statistics for a particular IP multicast group."
  372.         INDEX { igmpGroupIfIndex, igmpGroupAddress }
  373.         ::= { igmpGroupTable 1 }
  374.  
  375. IgmpGroupEntry ::=
  376.     SEQUENCE {
  377.         igmpGroupIfIndex
  378.             INTEGER,
  379.         igmpGroupAddress
  380.             IpAddress,
  381.         igmpState
  382.             INTEGER,
  383.         igmpReceivedDatagrams
  384.             Counter,
  385.         igmpOutReports
  386.             Counter,
  387.         igmpInReports
  388.             Counter,
  389.         igmpLastReportTime
  390.             TimeTicks,
  391.         igmpReportTimeoutInterval
  392.             INTEGER,
  393.         igmpGroupActivated
  394.             TimeTicks
  395.     }
  396.  
  397. igmpGroupIfIndex OBJECT-TYPE
  398.         SYNTAX  INTEGER
  399.         ACCESS  read-only
  400.         STATUS  mandatory
  401.         DESCRIPTION
  402.                 "This value is a unique integer for each interface
  403.                 as identified by the same value of IfIndex."
  404.         ::= { igmpGroupEntry 1 }
  405.  
  406. igmpGroupAddress OBJECT-TYPE
  407.         SYNTAX  IpAddress
  408.         ACCESS  read-only
  409.         STATUS  mandatory
  410.         DESCRIPTION
  411.                 "The address of the IP multicast group."
  412.  
  413.  
  414.  
  415. Pusateri                                                        [Page 7]
  416.  
  417.  
  418.  
  419.  
  420.  
  421. INTERNET DRAFT                                             February 1993
  422.  
  423.  
  424.         ::= { igmpGroupEntry 2 }
  425.  
  426. igmpState OBJECT-TYPE
  427.         SYNTAX  INTEGER {
  428.                         non-member (1),
  429.                         delaying-member (2),
  430.                         idle-member (3)
  431.                 }
  432.         ACCESS  read-only
  433.         STATUS  mandatory
  434.         DESCRIPTION
  435.                 "The current state of the IGMP host with respect to
  436.                 a particular group on a particular interface."
  437.         ::= { igmpGroupEntry 3 }
  438.  
  439. igmpReceivedDatagrams OBJECT-TYPE
  440.         SYNTAX  Counter
  441.         ACCESS  read-only
  442.         STATUS  mandatory
  443.         DESCRIPTION
  444.                 "The number of IP multicast datagrams received on this
  445.                 interface to this group address."
  446.         ::= { igmpGroupEntry 4 }
  447.  
  448. igmpOutReports OBJECT-TYPE
  449.         SYNTAX  Counter
  450.         ACCESS  read-only
  451.         STATUS  mandatory
  452.         DESCRIPTION
  453.                 "The number of Host Membership Report messages sent
  454.                 out of this interface to this group address."
  455.         ::= { igmpGroupEntry 5 }
  456.  
  457. igmpInReports OBJECT-TYPE
  458.         SYNTAX  Counter
  459.         ACCESS  read-only
  460.         STATUS  mandatory
  461.         DESCRIPTION
  462.                 "The number of Host Membership Report messages that
  463.                 have been received on this interface for this group
  464.                 address."
  465.         ::= { igmpGroupEntry 6 }
  466.  
  467. igmpLastReportTime OBJECT-TYPE
  468.         SYNTAX  TimeTicks
  469.         ACCESS  read-only
  470.         STATUS  mandatory
  471.         DESCRIPTION
  472.  
  473.  
  474.  
  475. Pusateri                                                        [Page 8]
  476.  
  477.  
  478.  
  479.  
  480.  
  481. INTERNET DRAFT                                             February 1993
  482.  
  483.  
  484.                 "The value of sysUpTime when the last Group
  485.                 Membership Report for this group address was
  486.                 received on this interface."
  487.         ::= { igmpGroupEntry 7 }
  488.  
  489. igmpReportTimeoutInterval OBJECT-TYPE
  490.         SYNTAX  INTEGER (1..'7FFFFFFF'h)
  491.         ACCESS  read-write
  492.         STATUS  mandatory
  493.         DESCRIPTION
  494.                 "The value in seconds that the multicast group denoted
  495.                 by this group address will stay registered on this
  496.                 interface without being refreshed before it is deleted."
  497.         ::= { igmpGroupEntry 8 }
  498.  
  499. igmpGroupActivated OBJECT-TYPE
  500.         SYNTAX  TimeTicks
  501.         ACCESS  read-only
  502.         STATUS  mandatory
  503.         DESCRIPTION
  504.                 "The value of sysUpTime at the time the group was
  505.                 initially registered with the interface.  If the group
  506.                 was registered prior to the last reinitialization of
  507.                 the local network management subsystem, then this
  508.                 object contains a zero value."
  509.         ::= { igmpGroupEntry 9 }
  510.  
  511. END
  512.  
  513.  
  514.  
  515. 7.  Acknowledgments
  516.  
  517.  
  518.  
  519.    The author would like to thank Greg Minshall, Jeff Honig, and
  520.    John Moy for their review and constructive comments.
  521.  
  522.  
  523. Author's  Address:
  524.  
  525.    Thomas J. Pusateri
  526.    Consultant
  527.    11820 Edgewater Ct.
  528.    Raleigh, NC 27614
  529.  
  530.    pusateri@cs.duke.edu
  531.  
  532.  
  533.  
  534.  
  535. Pusateri                                                        [Page 9]
  536.  
  537.  
  538.  
  539.  
  540.  
  541. INTERNET DRAFT                                             February 1993
  542.  
  543.  
  544. 8.0 References
  545.  
  546.  
  547.  
  548. [1]  S. Deering, Host Extensions for IP Multicasting, Internet Working
  549.      Group Request for Comments 1112.  Network Information Center, SRI
  550.      International, Menlo Park, California, (Aug, 1989).
  551.  
  552.  
  553. [2]  M.T. Rose and K. McCloghrie, Structure and Identification of
  554.      Management Information for TCP/IP-based internets, Internet Working
  555.      Group Request for Comments 1155.  Network Information Center, SRI
  556.      International, Menlo Park, California, (May, 1990).
  557.  
  558.  
  559. [3]  M.T. Rose, Concise MIB definitions Internet Working Group Request
  560.      for Comments 1212.  Network Information Center, SRI International,
  561.      Menlo Park, California, (March, 1991).
  562.  
  563.  
  564. [4]  K. McCloghrie and M.T. Rose, Management Information Base for
  565.      Network Management of TCP/IP-based internets, Internet Working
  566.      Group Request for Comments 1156.  Network Information Center, SRI
  567.      International, Menlo Park, California, (May, 1990).
  568.  
  569.  
  570. [5]  M.T. Rose (editor), Management Information Base for Network
  571.      Management of TCP/IP-based internets, Internet Working Group
  572.      Request for Comments 1213.  Network Information Center, SRI
  573.      International, Menlo Park, California, (March, 1991).
  574.  
  575.  
  576. [6]  J.D. Case, M.S. Fedor, M.L. Schoffstall, and J.R. Davin, Simple
  577.      Network Management Protocol, Internet Working Group Request for
  578.      Comments 1157.  Network Information Center, SRI International,
  579.      Menlo Park, California, (May, 1990).
  580.  
  581.  
  582. [7]  Information processing systems - Open Systems Interconnection -
  583.      Specification of Abstract Syntax Notation One (ASN.1),
  584.      International Organization for Standardization.  International
  585.      Standard 8824, (December, 1987).
  586.  
  587.  
  588. [8]  Information processing systems - Open Systems Interconnection -
  589.      Specification of Basic Encoding Rules for Abstract Notation One
  590.      (ASN.1), International Organization for Standardization.
  591.      International Standard 8825, (December, 1987).
  592.  
  593.  
  594.  
  595. Pusateri                                                       [Page 10]
  596.  
  597.  
  598.  
  599.  
  600.  
  601. INTERNET DRAFT                                             February 1993
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655. Pusateri                                                       [Page 11]
  656.  
  657.  
  658.